home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 30 / Amiga Format AFCD30 (Sep 1998, Issue 114).iso / -seriously_amiga- / sound / 8hz-mp3 / 8hz-mp3. / readme.8hz-mp3 < prev    next >
Text File  |  1998-06-18  |  6KB  |  139 lines
  1. -----------------------------------------------------------README---------------
  2.  
  3. Mon May 18 01:20:00 MET DST 1998
  4.  
  5. Contents
  6.   What is 8hz-mp3 ?
  7.   How to use it.
  8.   Known misfeatures.
  9.   How to contribute.
  10.   Version history.
  11.   Disclaimer.
  12.   List of Contributors.
  13.  
  14. -----------------------------------------------------------What is 8hz-mp3 ?----
  15. 8hz-mp3 is the name for our MPEG audio encoder,
  16.  
  17. SoloH's project "MpegEnc" gave us the idea to also have a go at an free encoder,
  18.   but with speed as our main goal, so we went at it.
  19.   We did it to learn something and have some fun while doing so.
  20.   It supports a number of platforms and will be ported to more eventually.
  21.   We took the same official ISO source as SoloH did and we poked around in it 
  22.   for a couple of days. It's free as is his, but we target more platforms. 
  23.   The result seems not to be too bad (we think). 
  24.  
  25. At this moment this encoder only supports MPEG I layer III. 
  26.   (but hey, what else would you want to encode anyway ??)
  27.   This encoder seems to be reasonably fast and it's totally free...
  28.  
  29.  
  30. -----------------------------------------------------------How to use it--------
  31.  
  32. This program reads windows .wav (RIFF-WAVE-MSPCM) sample-files.
  33.   Only 16-Bit samples are supported.
  34.   8hz-mp3 encodes a .mp3 file with the same channel mode as the .wav file has.
  35.   (either mono or stereo)
  36.   
  37. |  8hz-mp3 1998 8Hz software
  38. |  USAGE   : 8hz-mp3 [options] infile outfile
  39. |  OPTIONS : -h            this help message
  40. |            -b bitrate    set the bitrate, default 128kbit
  41. |            -c            set copyright flag, default off
  42. |            -o            set original flag, default off
  43.  
  44.   Valid samplerates are : 32000, 44100 and 48000Hz
  45.   (eg, samples with other samplerates are rejected by the encoder.)
  46.   Valid bitrates are : 32,40,48,56,64,80,96,112,128,160,192,224,256 and 320
  47.  
  48. For example :
  49. |  8hz-mp3 -b 128 -c -o blah.wav blah.mp3
  50. (This will encode the sample blah.wav into blah.mp3, with a bitrate of
  51.  128kBit/sec with the 'copyright' and 'original' flags set to 'on')
  52. The copyright and original flags do not add anything to the mp3 file, they 
  53. just let you specify the status of the music file.
  54.  
  55. -----------------------------------------------------------Known misfeatures----
  56.  
  57. These are the know misfeatures (bugs ?:)
  58.   *It is known to crash. (but not often *phew*)
  59.   *If you want the best quality, you should go with a Fraunhofer encoder.
  60.    These really are the best, by far. Speed or no speed. 
  61.    Xing-engine based programs are blazing fast, but they cut-off at 16Khz, 
  62.    so they have way less work to do.
  63.    8hz-mp3 is a nice go at something usefull, but quality wise it is under par.
  64.    (Quality is on the same level as the other (ISO Source based) free encoder 
  65.     'MpegEnc' from SoloH:  http:www.isafeelin.org/SoloH)
  66.   *Some residual debug output will from time to time be printed.
  67.  
  68. -----------------------------------------------------------How to contribute----
  69.  
  70. As it will be very exciting (and usefull :) to have the software on all kinds
  71.   of machines/OS' and due to the many requests we have decided to put the 
  72.   source of the next version online, so everybody can port it to the platforms 
  73.   they desire.
  74.  
  75. We'd like to 'coordinate' a wider effort to get these ISO sources fast and
  76.   better than they are now, many people have already mentioned they'd like to
  77.   help. When the sources for v0.2 are available we'll be waiting for all your 
  78.   patches and updates to use them in the next version.
  79.  
  80. For more information read the deveopment page at : http://www.8hz.com/mp3/devel/
  81.  
  82. -----------------------------------------------------------Version History------
  83.  
  84. version 0.1b
  85.   Removed all MPEG Layer I/II support,
  86.   Removed all MPEG II support,
  87.   Rearranged some routines,
  88.   Optimised a little ( at least 40%, for intel based machines ).
  89.  
  90. version 0.11b (Microsoft windows 95/NT only)
  91.   Hacked a simple GUI.
  92.  
  93. -----------------------------------------------------------Disclaimer-----------
  94.  
  95. This software is the result of the experimenting we've done with the
  96.   original ISO sources, the primary goal of which was for us to learn.
  97.  
  98. These software programs are available to the user without any 
  99.   license fee or royalty on an "as is" basis.  
  100.  
  101. We disclaim all warranties and fitness for a particular purpose,
  102.   in short "use at your own risk".
  103.  
  104. In no event we will accept liability for any incidental, punitive, 
  105.   or consequential damages of any kind whatsoever arising from the 
  106.   use of this program.
  107.  
  108. We do not represent or warrant that the programs furnished hereunder 
  109.   are free of infringement or any third-party patents, copyrights 
  110.   or trade secrets.
  111.  
  112. -----------------------------------------------------------List of Contributors-
  113.  
  114. The performance increase, WAVE support and 'uncluttering' of the code:
  115. 8hz-mp3: (general email: 8hz-mp3@8hz.com)
  116.  
  117. alex@8hz.com   (A.R. v. Ballegooy) 
  118. goran@8hz.com  (G. Dokic)
  119.  
  120.  
  121. This is the list of contributors the documentation with the original 
  122. ISO sources gives. (These people know their stuff, Respect!)
  123.  
  124. Bill Aspromonte    Shaun Astarabadi    R. Bittner          Karlheinz Brandenburg
  125. W. Joseph Carter   Jack Chang          Mike Coleman        Johnathan Devine
  126. Ernst Eberlein     Dan Ellis           Peter Farrett       Jean-Georges Fritsch
  127. Vlad Fruchter      Hendrik Fuchs       Bernhard Grill      Amit Gulati
  128. Munsi Haque        Chuck Hsiao         Toshiyuki Ishino    Masahiro Iwadare
  129. Earl Jennings      James Johnston      Leon v.d. Kerkhof   Don Lee
  130. Mike Li            Yu-Tang Lin         Soren Neilsen       Simao F. Campos Neto
  131. Mark Paley         Davis Pan           Tan Ah Peng         Kevin Peterson
  132. Juan Pineda        Ernst F. Schroeder  Peter Siebert       Jens Spille
  133. Sam Stewart        Al Tabayoyon        Kathy Wang          Franz-Otto Witte
  134. Douglas Wong
  135.  
  136.  
  137.  
  138. --------------------------------------------------------------------------------
  139.